Skip to main content

TideCloak Linux Prerequisites

This guide helps you install all required tools to run and configure TideCloak on a Linux-based environment.

These prerequisites ensure your system is ready for local development, integration, or production deployment of TideCloak's decentralized identity infrastructure.

Required Tools​

You will install the following components:

  • sudo
  • git
  • gh (GitHub CLI)
  • wget
  • JDK 22
  • .NET 8 SDK
  • Node.js with TypeScript
  • Docker Engine + Compose

1. Install sudo​

sudo apt-get update -y
sudo apt-get install -y sudo
sudo adduser <your-username> sudo

Verify:

sudo -l

2. Install git​

sudo apt-get install -y git

Verify:

git --version

3. Install GitHub CLI (gh)​

sudo apt-get update
sudo apt-get install -y wget apt-transport-https gnupg

wget -qO- https://cli.github.com/packages/githubcli-archive-keyring.gpg \
| sudo tee /etc/apt/keyrings/githubcli-archive-keyring.gpg >/dev/null

sudo chmod go+r /etc/apt/keyrings/githubcli-archive-keyring.gpg

echo \
"deb [arch=$(dpkg --print-architecture) \
signed-by=/etc/apt/keyrings/githubcli-archive-keyring.gpg] \
https://cli.github.com/packages stable main" \
| sudo tee /etc/apt/sources.list.d/github-cli.list >/dev/null

sudo apt-get update
sudo apt-get install -y gh

Verify:

gh --version

Authenticate with GitHub​

Generate a Personal Access Token (scopes: repo, read:org, workflow), then:

gh auth login

Follow prompts and choose:

  • GitHub.com
  • HTTPS
  • Paste authentication token

Check status:

gh auth status

4. Install wget​

sudo apt-get install -y wget

Verify:

wget --version

5. Install JDK 22​

wget https://download.java.net/java/GA/jdk22.0.1/c7ec1332f7bb44aeba2eb341ae18aca4/8/GPL/openjdk-22.0.1_linux-x64_bin.tar.gz
tar xvf openjdk-22.0.1_linux-x64_bin.tar.gz
sudo mv jdk-22.0.1 /usr/local/jdk-22

cat << 'EOF' | sudo tee /etc/profile.d/jdk22.sh
export JAVA_HOME=/usr/local/jdk-22
export PATH=$PATH:$JAVA_HOME/bin
EOF

source /etc/profile.d/jdk22.sh

Verify:

java -version

6. Install .NET 8 SDK​

wget https://packages.microsoft.com/config/debian/12/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
sudo dpkg -i packages-microsoft-prod.deb && rm packages-microsoft-prod.deb

sudo apt-get update
sudo apt-get install -y dotnet-sdk-8.0 clang zlib1g-dev

Verify:

dotnet --version

7. Install Node.js + TypeScript​

sudo apt-get install -y nodejs npm
sudo npm install -g typescript

Verify:

node -v
tsc -v

8. Install Docker Engine + Compose​

sudo apt-get remove -y docker.io docker-doc docker-compose podman-docker containerd runc
sudo apt-get update
sudo apt-get install -y ca-certificates curl gnupg

sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/debian/gpg \
| sudo tee /etc/apt/keyrings/docker.asc >/dev/null

sudo chmod a+r /etc/apt/keyrings/docker.asc

echo \
"deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] \
https://download.docker.com/linux/debian $(. /etc/os-release && echo $VERSION_CODENAME) stable" \
| sudo tee /etc/apt/sources.list.d/docker.list >/dev/null

sudo apt-get update
sudo apt-get install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

Verify:

sudo docker run hello-world

You're Ready!​

Proceed to: